home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / dviware / dview / dview.arc / DVIEW.DOC < prev    next >
Text File  |  1989-03-31  |  6KB  |  125 lines
  1. DVIEW DVI File Viewer   version 2.5                       Steve Ward 10/87
  2.  
  3. DVIEW is a program for IBM PC compatibles for viewing TeX .dvi output
  4.  files, including those using the MIT graphics extensions.  Currently
  5.  DVIEW supports the CGA and the high-resolution mode of the Toshiba
  6.  T3100 (& presumably the T5100); other displays may be supported in
  7.  time.
  8.  
  9.  
  10. QUICK START:  You can get DVIEW up and running, and read a TeX-formatted
  11.  version of this information, by moving PXL files from this archive
  12.  to the appropriate subdirectories, and typing "DVIEW DVIEW".  To do
  13.  so without reading further (on a PC with CGA-compatible display),
  14.  type "RUNME".
  15.  
  16. OVERVIEW: DVI files are standard and machine-independent; they may
  17.  be generated on the PC or downloaded from another source.  Viewing
  18.  them requires DVIEW plus a set of appropriate font files, which again
  19.  are standard Metafont output (PXL) files and can be downloaded from
  20.  any of a variety of sources.  DVIEW reads each page and builds a
  21.  virtual bitmap (in RAM), then blts segments onto your display as you
  22.  move around the virtual page (using arrow keys).  During the building
  23.  process DVIEW shows its progress via a reduced image of the page; this
  24.  overview is recoverable by pressing "?" subsequently.  The size and 
  25.  shape of the virtual page, as well as a scale factor, are variable
  26.  via obscure command-line arguments (see below); they default to values
  27.  which allow most papers to just fit horizontally, requiring scrolling
  28.  only in the vertical dimension.
  29.  
  30. FONT FILES: By default, these live in a subtree /PXL on your PC.  /PXL
  31.  contains subdirectories with numeric names like /PXL/480, indicating
  32.  resolution; entries in the subdirectories are PXL files with names
  33.  like /PXL/480/CMR10.PXL, indicating the font.  You need only to
  34.  download the specific files used by your paper -- a reasonably complete
  35.  set can run into many megabytes.  To help you manage fonts, DVIEW
  36.  (1) after warning you, will try to substitute a smaller font of the
  37.  same style for any missing fonts; (2) allows you to review the font
  38.  situation using the "f" command; and (3) writes out a file "MISSING.FNT"
  39.  which indicates the additional fonts you need to download.  If you
  40.  upload MISSING.FNT to hx:/archive/pxl, change into /PXL on your PC and
  41.  run TX, then a MAKE on HX will download the correct fonts.  Presumably
  42.  this situation can be duplicated elsewhere; look in hx:/archive/pxl
  43.  for our local PC-appropriate font cache.
  44.  
  45. PICTURES: DVIEW understands the simple M.I.T. extensions for drawing lines,
  46.  allowing pictures (created e.g. using GEDIT on the PC) in TeX
  47.  documents to be viewed.  See DVIEW.DVI for a simple example.
  48.  
  49. DVIEW.TMP: Because font loading takes some time (a LOT on an old PC,
  50.  a few seconds even on the T3100) DVIEW offers the "t" command (or
  51.  "-t" command line option) to cause a dump of its fonts and parameters
  52.  into a fast-load file DVIEW.TMP.  If DVIEW finds DVIEW.TMP on a
  53.  subsequent invocation, it loads it and presumably restores your
  54.  parameters (including display type) and fonts.  This step is worth
  55.  taking if you will be repeatedly viewing edited versions of the same
  56.  file.  You can delete DVIEW.TMP and/or make a new one at any point,
  57.  eg if you change the set of fonts you are using.
  58.  
  59. COMMAND SUMMARY: Once in DVIEW viewing a page, you can type:
  60.  
  61.           ?  HELP information (this summary)
  62.          UP  move page up
  63.        DOWN  move page down
  64.        LEFT  shift page left
  65.       RIGHT  shift page right
  66.        HOME  top of page
  67.         END  bottom of page
  68.        PgUp  double step size
  69.        PgDn  halve step size
  70.           t  write state into DVIEW.TMP
  71.           f  show font list
  72.           p  Print (low-res) page
  73.     <digit>  enter new page number
  74.       SPACE  next page
  75.      BACKSP  previous page
  76.      RETURN  back to page 1
  77.         TAB  skip to last page
  78.         ESC  return to MS-DOS
  79.  
  80.  plus a few which I've probably forgotten.  Poke around a little.  Note
  81.  that the above info is online.
  82.  
  83. When fired up with no arguments, DVIEW gives you the following terse
  84.  command line help:
  85.  
  86. DVIEW DVI File Viewer   version 2.5   Steve Ward
  87. DVIEW <options> <dvifile>     [version 2.5]
  88.  <options> or DVIEW envstring may include:
  89.         -x\# adjusts horizontal page offset. [default: 25]
  90.         -y\# adjusts vertical page offset. [0]
  91.         -R\# sets resolution to # [default 96; try 80]
  92.         -F<path> sets font directory to <path> [/pxl]
  93.         -X\# set virtual page X size, in BYTES. [90]
  94.         -Y\# set virtual page Y size, in LINES. [1000]
  95.         -m\# sets page map width to #. [300]
  96.         -dc sets display to type c (c=cga,t=toshiba3100,e=ega)[c]
  97.         -t  writes DVIEW.TMP as font/parameter cache
  98.         -t<name>  writes <name> as font/parameter cache
  99.  
  100. If you are wildly experimental and don't like the parameters DVIEW defaults
  101.  to, you can try some of the above.  Start with "dview file" (or, on e.g. a
  102.  T3100, "dview -dt file") and play a little.
  103.  
  104. ENVIRONMENT VARIABLE: When invoked, DVIEW looks for a value bound to
  105.  the environment variable DVIEW, and interprets it as command line
  106.  options.  Thus, for example, the line
  107.  
  108.      set DVIEW = -de -F/tex/fonts/
  109.  
  110.  in your AUTOEXEC.BAT file causes DVIEW to assume by default an EGA and
  111.  the subdirectory tree /TEX/FONTS/... for fonts.
  112.  
  113.  
  114.  
  115. \Section{Distribution}
  116.  
  117. DISTRIBUTION: DVIEW may be freely distributed, and used for any purpose
  118.  by anybody.  If you can figure out how to make money from it despite the
  119.  fact that I'm giving it away, you're welcome to.  I like the idea that
  120.  free software is free -- that is, completely unencumbered.
  121.  
  122.  
  123. (end)
  124.  
  125.